home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sfbibtrv.zip / SFBIBTRV.DOC < prev    next >
Text File  |  1991-02-25  |  20KB  |  462 lines
  1.  
  2.      "...For the wages of sin is death, but the gift of God
  3.                is eternal life through Jesus Christ our Lord." (Romans 6:23)
  4.  
  5.  
  6.  ╔══════════════════════════════════════════════════════════════════════════╗
  7.  ║  ─┬─ ╖ ┌ ╥─┐     ╥─╖ ╖  ╓ ╓─╖ ╖─╖ ╓─╖ ╥─╖ ╖   ╥ ╓─╖ ─╥─     ╥─╖ ╥─╖ ╓─╖  ║
  8.  ║   │  ╟─┤ ╟─      ╟─  ╙╖╓╜ ╟─╢ ║ ║ ║ ╥ ╟─  ║   ║ ╙─╖  ║      ╟─╢ ╟─╢ ╙─╖  ║
  9.  ║   ┴  ╜ └ ╨─┘     ╨─╜  ╙╜  ╜ ╙ ╨ ╨ ╙─╜ ╨─╜ ╙─╜ ╨ ╙─╜  ╨      ╨─╜ ╨─╜ ╙─╜  ║
  10.  ╚══════════════════════════════════════════════════════════════════════════╝
  11.  
  12.    ▄       ╔══════════════════════════════════════════════════════╗       ▄
  13.   ▀█▀      ║     A BBS DEDICATED TO THE PROMOTING OF BIBLICAL     ║      ▀█▀
  14.    █       ║ TRUTH AND THE DISTIBUTING OF SOUND BIBLICAL ARTICLES ║       █
  15.            ║ TO THE GLORY OF GOD AND THE EDIFYING OF HIS CHILDREN ║
  16.            ╚══════════════════════════════════════════════════════╝
  17.  ╒════════════════════════════╕                 ╒═══════════════════════════╕
  18.  │   (Cope Jonkman),  Sysop   │        ▄        │Practical Peripherals 2400B│
  19.  │       1200/2400 Baud       │       ▀█▀       │   Apex Epson XT Computer  │
  20.  │   Open Monday to Saturday  │        █        │     30 Meg Disk Space     │
  21.  │       (519) 448-3223       │                 │         Public BBS        │
  22.  ╘════════════════════════════╛                 ╘═══════════════════════════╛
  23.  
  24.  
  25.  
  26.  
  27.                              in cooperation with
  28.                             Buffalo Creek Software
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                                  SFBIBTRV
  35.  
  36.                           SPITFIRE BIBLE QUIZ DOOR
  37.  
  38.                         by Cope and Margaret Jonkman
  39.  
  40.                     
  41.                                     of
  42.  
  43.                             THE EVANGELIST BBS
  44.  
  45.  
  46.    INTRODUCTION
  47.    ------------
  48.  
  49.    SFBIBTRV is a fast paced Biblical quiz game designed to run as a
  50.    door feature within the SPITFIRE Bulletin Board System.  It can also be
  51.    installed as a sysop configurable command from the Main, File or
  52.    Message menus of SPITFIRE.  A data file containing over 500 Bible
  53.    quiz questions is randomly accessed and displayed to the
  54.    screen.  With each question that is displayed, four multiple choice
  55.    options are provided from which the player may select.  SFBIBTRV allows
  56.    the SYSOP to configure the delay time (defaults to ten seconds) that
  57.    the player is allowed to read the question and respond with the number
  58.    corresponding to the answer they wish to select.
  59.  
  60.  
  61.    SFBIBTRV COMMAND LINE PARAMETERS
  62.    --------------------------------
  63.  
  64.       /P - Designates the drive, path, filename and extension of the
  65.            high score bulletin to be used with SFBIBTRV
  66.  
  67.       /D - Designates the delay time (in seconds) that the user is
  68.            allowed to answer the question before it "times out".
  69.  
  70.       /L - Allows local usage of SFBIBTRV
  71.  
  72.  
  73.    The /P command line parameter is available which will automatically
  74.    create Ansi and Non-Ansi high score bulletins for your BBS system.
  75.    If you would like to use this option, a "/P" should follow the
  76.    SFBIBTRV in the command line to indicate a valid DOS path where the
  77.    bulletin file will be created.  (NOTE: This should be the same as the
  78.    display file path you have set up within SPITFIRE.)  The path is then
  79.    followed by the file name of the bulletin to be created.  It is not
  80.    necessary to include the file extension.  SFBIBTRV will automatically
  81.    add a .BBS extension for the Non-Ansi display file and a .CLR
  82.    extension for the Ansi display file created.  The correct syntax
  83.    should look like this:
  84.  
  85.    SFBIBTRV /P C:\SF\DISPLAY\DORBUL1
  86.  
  87.    The "/P" command line is optional and SFBIBTRV will operate perfectly
  88.    fine without it.  However, it is a convenient means of providing and
  89.    posting high score bulletins for the Bible quiz door.
  90.  
  91.  
  92.    The /D command line parameter is also available which will allow the
  93.    Sysop to designate the delay time (in seconds) that is allowed
  94.    between the time the question prompt is displayed to the screen and
  95.    when the user must enter the desired answer.  This is done using the
  96.    /Dnn (where nn represents the number of seconds) command line
  97.    parameter.  As an example, if the Sysop wishes to allow a 15 second
  98.    delay, a /D15 would be entered on the command line as illustrated
  99.    below:
  100.  
  101.    SFBIBTRV /D15
  102.  
  103.    If no /Dnn is designated at the command line, SFBIBTRV will default
  104.    to a ten second delay.
  105.  
  106.  
  107.    The /L command line parameter will allow SFBIBTRV to be played
  108.    locally without requiring a SFDOORS.DAT, SFMAIN.DAT, SFMESS.DAT or
  109.    SFFILE.DAT file.  Using the /L command line parameter disables the
  110.    program's carrier detect monitoring and redirection of the game
  111.    through the comm port.  For local operation of SFBIBTRV enter the
  112.    following command at the DOS prompt:
  113.  
  114.    C:> SFBIBTRV /L
  115.  
  116.    ** SPECIAL NOTE ** The /L, /P and /D command parameters can be used
  117.    together in one command line to specify the drive, path and filename
  118.    of the bulletin to be created and the delay time in seconds when
  119.    playing in local mode.
  120.  
  121.    It should also be noted that the /P, /D and /L command line
  122.    parameters may appear in any order on the command line.  SFBIBTRV
  123.    does NOT require these to be used in a specific order.
  124.  
  125.  
  126.  
  127.    SFBIBTRV SETUP AS A SPITFIRE DOOR
  128.    ---------------------------------
  129.  
  130.    To set up SFBIBTRV to be executed as a door, it is recommended that a
  131.    separate directory be set up for it.  For explanation purposes, let's
  132.    assume the directory DOOR_A is created for use with SFBIBTRV.  The
  133.    following files must then be placed in the directory:
  134.  
  135.    SFBIBTRV.EXE    The actual game program.
  136.  
  137.    SFBIBTRV.DAT    The data file containing the trivia questions.
  138.  
  139.    SFBIBTRV.TOP    This is a listing of the top ten players.  SFBIBTRV.EXE
  140.                        will create this file if it is not found.
  141.  
  142.    SFBIBTRV.LMT    This allows you to set time limits according to the
  143.                    callers security level.
  144.  
  145.    The Sysop will then need to use a text editor to edit the SF.BAT file
  146.    as illustrated below:
  147.  
  148.    :DOOR_A
  149.    COPY SFDOORS.DAT C:\SF\DOOR_A
  150.    SFBIBTRV
  151.    ERASE SFDOORS.DAT
  152.    GOTO LOOP
  153.    :DOOR_B
  154.  
  155.  
  156.    You will notice that the commands needed to execute SFBIBTRV are
  157.    placed between the :DOOR_A and GOTO LOOP command lines.  These are
  158.    entered in place of the existing REM Place Program Name Here.  The
  159.    following will briefly explain each of the commands which were set up
  160.    within SF.BAT to run SFBIBTRV as a SPITFIRE Door program:
  161.  
  162.    SFDOORS.DAT is created automatically by SPITFIRE when a user enters a
  163.    door.  It contains information about the user such as name and
  164.    password.  SFBIBTRV requires access to the information within
  165.    SFDOORS.DAT.  Therefore, before executing the program it must be
  166.    copied to the directory in which SFBIBTRV is running.
  167.  
  168.    SFBIBTRV is the program name and executes the game program from
  169.    within the door program.
  170.  
  171.    Once the user has terminated the game play of SFBIBTRV, SPITFIRE
  172.    erases the SFDOORS.DAT file.
  173.  
  174.  
  175.  
  176.    SFBIBTRV SETUP AS A SYSOP CONFIGURABLE COMMAND
  177.    ----------------------------------------------
  178.  
  179.    SPITFIRE has a sysop configurable command for the Main, Message and
  180.    File menus.  The sysop configurable command is executed through a
  181.    batch file which corresponds to the menu it is being run from.  In
  182.    other words, SFMAIN.BAT runs the sysop configurable command from the
  183.    Main Menu, SFMESS.BAT runs the one from the Message Menu and
  184.    SFFILE.BAT the one from the File Menu.  The commands necessary to
  185.    execute SFBIBTRV can be set up in the batch file which corresponds to
  186.    the menu you wish to have SFBIBTRV run from.
  187.  
  188.    The first thing you will need to establish is which of these menus
  189.    you wish to use to run SFBIBTRV.  For this purpose, let's assume that
  190.    it is going to be set up so it can be run from the Main Menu.  (It
  191.    should be noted the set up procedure is the same regardless of which
  192.    Menu you are running SFBIBTRV from.)
  193.  
  194.    Next, you will need to decide what you wish to name the command
  195.    option and establish what security level will be required for users
  196.    of your system to be able to access this option.  Once this is
  197.    determined you will need to modify the SFMAIN.MNU file using your
  198.    favorite text editor, as long as it saves in ASCII format.  (Refer to
  199.    the SPITFIRE manual for further documentation on this if needed.  It
  200.    should also be noted that if SFBIBTRV were being set up to run from
  201.    the File Menu, you would need to modify the SFFILE.MNU file and if it
  202.    was being set up to be run from the Message Menu you would need to
  203.    modify the SFMSG.MNU file.)
  204.  
  205.  
  206.    Examining the default SFMAIN.MNU file, you will notice the sysop
  207.    configurable command appears as:
  208.  
  209.         <K>............. Add Your Own,,1000,@
  210.  
  211.  
  212.    This will need to be replaced with a Command Character that will be
  213.    used to select the option from the menu.  It is ABSOLUTELY IMPERATIVE
  214.    that the Command Character must not duplicate an existing Command
  215.    Character for another menu option.  You will then need to include a
  216.    brief description of the Spitfire door program you are running, two
  217.    commas, the security level required to access this feature, and
  218.    another comma followed by the a @.  The @ must not be changed!  (For
  219.    more detailed information on modifying your SFMAIN.MNU, SFMSG.MNU or
  220.    SFFILE.MNU refer to your SPITFIRE manual.)
  221.  
  222.        <K>.... Brief Program Description,,10,@
  223.  
  224.    Now you will need to modify the corresponding batch file, SFMAIN.BAT,
  225.    so that it can be executed from the Main Menu.  Do this using your
  226.    favorite text editor, as long as it saves in ASCII format.  (Again,
  227.    it should be noted that if SFBIBTRV were being set up to run from the
  228.    File Menu, you would need to modify the SFFILE.BAT file and if it was
  229.    being set up to be run from the Message Menu you would need to modify
  230.    the SFMESS.BAT file.)
  231.  
  232.    Place the SFBIBTRV.EXE file in the directory you wish to run the
  233.    program from.  SFBIBTRV will create its own player score file,
  234.    SFBIBTRV.TOP, if does not already exist.
  235.  
  236.    The commands set up in the SFMAIN.BAT file are very similar to those
  237.    used for executing the game through a door in the SF.BAT file.  For
  238.    instance, if you were running SFBIBTRV from the main SPITFIRE
  239.    directory your SFMAIN.BAT file might look like this:
  240.  
  241.        ECHO OFF
  242.        BRK OFF
  243.        SFBIBTRV
  244.        BRK ON
  245.  
  246.    (BRK is not included in the SFBIBTRV package because it is written
  247.    and copyrighted by Solid Systems, 1985, but can be downloaded from
  248.    The EVANGELIST BBS and Buffalo Creek's BBS as well as a number of
  249.    other BBS systems. BRK is not required to run SFBIBTRV, however, it
  250.    is recommended since it will prevent a user using the CTRL BRK
  251.    command to terminate the batch file, gaining access to your system at
  252.    the DOS level.)
  253.  
  254.    If you wish to set SFBIBTRV up in a separate subdirectory from
  255.    SPITFIRE, for instance, a subdirectory named SFBIBTRV, your batch
  256.    file might look like this.
  257.  
  258.        ECHO OFF
  259.        BRK OFF
  260.        COPY SFMAIN.DAT \SF\SFBIBTRV
  261.        CD \SF\SFBIBTRV
  262.        SFBIBTRV
  263.        ERASE SFMAIN.DAT
  264.        CD \SF
  265.        BRK ON
  266.  
  267.  
  268.    When SFBIBTRV is executed, from either the door with the SF.BAT file
  269.    or from the sysop configurable command through a menu with the
  270.    corresponding batch file, it will first look for the SFMAIN.DAT file,
  271.    then the SFMESS.DAT file, then the SFFILE.DAT file and lastly the
  272.    SFDOORS.DAT file.  It will look for each of these files until it
  273.    finds it and the commands required for its execution.  If none of
  274.    these files are found, SFBIBTRV will halt its execution.
  275.  
  276.  
  277.    DTE LOCK FEATURE
  278.    ----------------
  279.  
  280.    SFBIBTRV automatically detects if the DTE is locked at 19200 baud.
  281.    If SFBIBTRV detects that the DTE is locked, then SFBIBTRV opens the
  282.    serial port to the maximum baud rate of your system.  If SFBIBTRV
  283.    does not detect that the DTE is locked, then the serial port is
  284.    opened to the baud rate of the caller.
  285.  
  286.  
  287.    SFBIBTRV ON A MULTI-NODE SYSTEM
  288.    -------------------------------
  289.  
  290.    SFBIBTRV is fully compatible for operation on a multi-node BBS.  It
  291.    automatically handles any file locking and file sharing required
  292.    during the doors execution.
  293.  
  294.  
  295.    SYSOP FEATURES
  296.    --------------
  297.  
  298.    First, a status line is now displayed on the BBS monitor that
  299.    provides information concerning the caller's name, baud rate of the
  300.    caller and the security level of the caller.
  301.  
  302.    A SFBIBTRV.LMT file allows the sysop to establish a time limit for
  303.    door play according to the security level the caller has on the
  304.    system.  To modify the accompanying SFBIBTRV.LMT file, use your
  305.    favorite text editor to represent the various security levels you
  306.    have available on your system, a comma then the corresponding time
  307.    you wish to allow for that particular security level in minutes.  For
  308.    instance, it might look like this:
  309.  
  310.    10,15
  311.    25,20
  312.    50,25
  313.    999,30
  314.  
  315.    Each security level should begin a new line and you should have a
  316.    setting for each security level you have available on your system.
  317.    If you do not have a time limit set for a particular security SFBIBTRV
  318.    will default to the level 10 security level setting.
  319.  
  320.    Pressing the Shift Key and the F1 key simultaneously will terminate
  321.    game play of SFBIBTRV and return the caller back to the BBS.
  322.    Pressing the Shift Key and the F9 key simultaneously will terminate
  323.    game play of SFBIBTRV and log the caller off of the BBS.  If the
  324.    Shift Key and the F9 key are pressed together, logging the caller off
  325.    the BBS, SPITFIRE will recycle and return to the SPITFIRE Ready For
  326.    Caller Prompt.
  327.  
  328.  
  329.    SFBIBTRV EXECUTION
  330.    ------------------
  331.  
  332.    When first executed, SFBIBTRV will display a list of the Top Ten high
  333.    score players and the percentage of correct responses they achieved
  334.    while playing SFBIBTRV.  Initially, this will be a dummy listing with
  335.    ten lines that display:
  336.  
  337.       0%...............YOUR NAME COULD BE HERE
  338.  
  339.    However, as the game is played, this will fill with the name of the
  340.    players, their percentage ratings and the date that the player was
  341.    added to the top ten listing.
  342.    NOTE: At least twenty questions must be attempted before SFBIBTRV
  343.          will will figure the percentage rating for the player.
  344.  
  345.    To keep things interesting...the Sysop can erase the file which
  346.    contains the top ten listings SFBIBTRV.TOP on a routine basis to give
  347.    additional players a chance to have their name added to the list.
  348.  
  349.    As the top ten list is displayed, at the bottom of the screen is a
  350.    question which prompts the user whether they want to have ANSI
  351.    Graphics (y/n)?  available to them during game play.  If the user
  352.    responds with a y (for yes) the game will display in color and if the
  353.    user responds with a n (for no) the game will display in monochrome.
  354.  
  355.  
  356.    Playing SFBIBTRV:
  357.    -----------------
  358.  
  359.    Immediately after pressing any key (other than <Q> for Quit) from the
  360.    Top Ten listing the game screen is displayed.  The screen will look
  361.    like the following:
  362.  
  363.    ---------------------------------------------------------------------
  364.     ╔═════════════════════════════════════════════╗
  365.     ║   >>>>>>>>>  Biblical  TRIVIA   <<<<<<<<<   ║
  366.     ║                 Version 1.0                 ║
  367.     ║      BIBLICAL Trivia Door For SPITFIRE!     ║
  368.     ║      THE EVANGLIST BSS * (519) 448-3223     ║
  369.     ║ In Cooperation with Buffalo Creek Software  ║
  370.     ║ Copyright (C) by Cope and Margaret Jonkman  ║
  371.     ║       UNREGISTERED SHAREWARE VERSION        ║
  372.     ╚═════════════════════════════════════════════╝
  373.  
  374.     RIGHT: 0                        WRONG: 0
  375.  
  376.     QUESTION:
  377.     The Biblical trivia question will be displayed
  378.     here.
  379.  
  380.     <1> Choice 1                        <2> Choice 2
  381.     <3> Choice 3                        <4> Choice 4
  382.  
  383.              Enter Answer: [ 1 2 3 4 <Q>uit]?
  384.  
  385.    ---------------------------------------------------------------------    
  386.    The first randomly chosen trivia question is selected from the data      
  387.    file and is displayed to the screen.
  388.  
  389.    The player makes his selection by entering the corresponding number.     
  390.    As the game progresses, SFBIBTRV will provide a running total of the
  391.    correct answers and also of the wrong answers the user has selected      
  392.    during the game play.
  393.  
  394.    If the ten second timer should elapse before you respond, SFBIBTRV
  395.    will count this as a wrong response and add an incorrect answer to       
  396.    the total WRONG answers obtained so far.
  397.  
  398.  
  399.    EXITING PLAY
  400.    ------------
  401.  
  402.    When you are ready to exit the game, simply select press "Q" for
  403.    <Q>uit.  If you qualify as one of the top ten players to date,
  404.    SFBIBTRV will congratulate you for becoming one of the top ten
  405.    scorers and add your name to the Top Ten listing.  You will once
  406.    again see the Top Ten list displayed with your name added to the
  407.    list.
  408.  
  409.    If you exit the game before you have completed the twenty questions      
  410.    required for eligibility to the Top Ten list or if you do not qualify    
  411.    as a Top Ten player, the Top Ten listing will be displayed and you
  412.     will be prompted to press any key to return to SPITFIRE.
  413.  
  414.  
  415.    DISTRIBUTION
  416.    ------------
  417.  
  418.    Please feel free to share SFBIBTRV.ZIP with others.  However, it must
  419.    be distributed with SFBIBTRV.EXE, SFBIBTRV.DAT, SFBIBTRV.TOP,
  420.    SFBIBTRV.LMT and the SFBIBTRV.DOC in the SFBIBTRV.ZIP distribution
  421.    package.  The files must not be altered in any way or by any means.
  422.  
  423.    PUBLIC DOMAIN - DISCLAIMER
  424.    --------------------------
  425.  
  426.    SFBBLTRV is distributed under the public domain concept.  The
  427.    software and its accompanying documentation are provided "as is"
  428.    without warranties expressed or implied as to the performance or
  429.    merchantability.  No registration fee is required and the program can    
  430.    be distributed freely.  However, by the use of SFBIBTRV, the user
  431.    assumes all responsibilities and agrees that Cope Jonkman or Margaret
  432.    Jonkman or The EVANGELIST BBS shall not be held liable for any
  433.    damage incurred to hardware, software or peripheral devices while        
  434.    running same.
  435.  
  436.    Should the user desire a copy stating that the SFBIBTRV program has
  437.    been registered to the user, they should call THE EVANGELIST BBS
  438.    and leave a comment to the sysop requesting this.  In a weeks time
  439.    if they call again a registered copy will be available as a personal
  440.    download.
  441.  
  442.    Many thanks are indeed owed to Mike Woltz of Buffalo Creek BBS (515)-    
  443.    225-8496 for his assistance.  Without his help this program would not    
  444.    have been possible.
  445.  
  446.  
  447.    History
  448.    -------
  449.  
  450.    Release 1    SFBIBTRV released.   02-25-91
  451.  
  452.  
  453.  
  454.    SFBIBTRV and other SPITFIRE programs are available for download from:
  455.  
  456.         Buffalo Creek BBS                    THE EVANGELIST BBS
  457.         Sysop, Mike Woltz                    Sysop, Cope Jonkman
  458.         Home of SPITFIRE                      Harrisburg, Ontario
  459.          (515) 225-8496                         (519) 448-3223
  460.        19200/9600/2400/1200                      2400/1200/300
  461.  
  462.